govee-bt-client

Govee H5xxx Bluetooth Client

A library to listen for the BLE (Bluetooth Low Energy) broadcasts from Govee Thermometer Hygrometer devices. Requires a compatible bluetooth module and operating system (see prepequisites).

Supported devices:

• H5072
• H5074
• H5075
• H5100
• H5101
• H5102
• H5179

Installation

npm install govee-bt-client

API

• startDiscovery: (callback: (reading: GoveeReading) => void)
  • Starts listening to broadcasts and pass decrypted data into the callback function.
• stopDiscovery()
  • Stops listening to broadcasts from Bluetooth
• debug: (on: boolean)
  • Function to enable debugging of bluetooth advertisements and peripherals.

Example

import { startDiscovery, stopDiscovery, debug } from "./index";

debug(true);

console.log("=== start discovery");

startDiscovery((reading) => {
    console.log(reading);
});

setTimeout(async () => {
    await stopDiscovery();
    console.log("=== stop discovery");
}, 30000);

Credits

Credits and thanks to

• Thrilleratplay/GoveeWatcher for explanation and examples of how to decode advertisement data for Govee H5075.
• Home-Is-Where-You-Hang-Your-Hack/sensor.goveetemp_bt_hci for explanation and examples of advertisement data for various Govee devices.
• @abandonware/noble for a great BLE library for node.
• andrewjbates and eharris for triaging and developing an algorithm to parse H5075 data below 0 degrees Celsius.